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ABSTRACT and CONTENTS 

This documents the interface between the phase one unpre- 
processor and both Ml CS and the MlCS user. The system 
interface includes all calls and parameters and the user 
interface includes all error messages . 
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The phase one unpreprocessor interfaces primarily with 
the model one compiler system. However, a temporary 
SPL user interface is present which manifests itself as 
a cryptic message whenever an unpreprocessor error occurs. 
This user interface is temporary for the SPL debugging 
phase only since unpreprocessor errors represent impos- 
sible conditions generated by bugs rather than users. 
Thus, phase two will see the same system interface with 
minor changes and no user interface. 

SYSTEM INTERFACE 



Calls: 



UNPP( LINE, BLOCK, MODE) ; 

This call will take the line whose symbol 
index is LINE in the block whose. token number is 
BLOCK and unpreprocess it into string UPS. See 
below for MODE interpretation. 

UNPK( BLOCK) ; 

This call will unpreprocess the line which is 
in the PPTB area according to its interpreta- 
tion in the block whose token number is BLOCK. 
The mode is set to 2 . 

UNPSI( LINE, BLOCK, TOKEN) ; 

This call functions like UNPP except the mode 
is set to 2 and TOKEN specifies some informa- 
tion to be obtained, specifically, the value 
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is the length of UPS before the Nth token is 
unpreprocessed into it. This value will be in 
the A register and global parameter UNCHN 
when control is relinquished. 

Formal parameters: 

LINE: Line symbol index of line to be unprepro- 
cessed. 

BLOCK: Global name table token number of block 
containing line to be unpreprocessed. 

TOKEN: An integer, N, where N ^> 0. This signifies 
the Nth token of the line to be unprepro- 
cessed and is used when requesting posi- 
tional information about the token in 
question. 

MODE: This parameter selects amongst four for- 
matting conventions concerned with spacing 
and automatic indentation. The conven- 
tions are selected by integers 1, 2, 3, 
and 4: 

1) Standard spacing is enforced regardless of 

space tokens embedded in the line. Consider- 
ing space tokens invisible, there remain three 
classes of tokens for spacing purposes: 
keyword (KEY), symbol/constant (S/C) , and 
all others (OTH) . The following table gives 
the standard spacing between token classes: 
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KEY 


KEY 


1 


s/c 


1 


OTH 


1 



S/C 

1 
1 





OTH 
1 





Standard spacing will put a space in column 

1 if the first non-blank token is not a keyword 

or symbol/constant. 

2) Duplicate the original text as encoded in tokens 

3) This mode is the same as (1) with the addition 
of standard indentation. Standard indentation 
will make the first label of a line, if it is 
the first non-blank token, left justified but 
start all- other text at a column prescribed by 
the compiler. The level of indentation is in- 
dicated in the PTIND field of a line cell, where 
means the left indentation margin and 1, 2 
...etc. mean that many additional indentation 
increments. The left indentation margin is set 
for column 8 and the indentation increment is 
set to 3 spaces. 

4) This mode is the same as (2) with the addition 
of standard indentation. 
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Global parameters: 

UMCONT - Controls the unpreprocessing of "L c " . 

= "&L", 1 = "L c " (page eject not implemented 
until phase 2) . 

PPTB - A single dimension array which must contain 
the line cell to be unpreprocessed if call 
UNPK( BLOCK) is used. 

UPS - The string which will contain the unpre- 
processed line when the unpreprocessor relin- 
quishes control. 

UNERR - Contains the error code if an error occurs 

UNCHN - First character number in UPS of token 
number TOKEN if call UNPSI (LINE, BLOCK, TOKEN) 
is used. If UNCHN is not set it will equal -1 

Termination: 

The normal termination is an SRETURN. RETURN 
occurs only if an error has occured . 

USER INTERFACE 

The user interface is temporary and used for 
debugging purposes only. It manifests itself in 
the form of an error message when an unpreproces- 
sor error occurs: 

XXX#UER£f 
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XXX is the error number and may be interpreted 
according to the list given below. This number 
should be given to someone on the SPL project as it 
indicates a system bug rather than a user error . 

UNPREPROCESSOR ERROR NUMBERS: 



5 
6 
7 
10 
11 
12 
13 
14 



unrecognizable token 
UPS string overflow 

keyword token not present or UPS overflow 
when inserting keyword 

special operator token not present or UPS over- 
flow when inserting keyword 
language type not implemented 
negative decimal integer 
unimplemented integer type (H,0) 
undefined integer type (6 or 7) 
impossible error 

constant type not yet implemented 
undefined token 
unimplemented string constant type 



